home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ADA Programming Guide
/
ADA Programming Guide.iso
/
adatutor
/
lrmrdr
/
sum.doc
< prev
next >
Wrap
Text File
|
1996-01-30
|
54KB
|
1,791 lines
<!OPS, Version = 6.4>
<!Document,
Final Output Device = "cx",
Default Printer = "nearest-cx">
<!Font Definitions,
F40 = Thames 10,
F101 = Swiss 18 Bold,
F57 = Thames 18 Bold,
F93 = Swiss 12 Bold,
F97 = Swiss 14 Bold,
F84 = Swiss 10,
F22 = Typewriter 10,
F85 = Swiss 10 Bold,
F41 = Thames 10 Bold,
F86 = Swiss 10 Italic,
F92 = Swiss 12>
<!Page,
Left Margin = 1 inches,
Right Margin = 1 inches,
Starting Page # = Inherit,
Hyphenation = on,
Revision Bar Placement = Left,
Feathering = off,
Max. Feathering = 8>
<!Autonumber Stream, Outline, 3,
Level 1 Symbol Type = Upper Roman,
Level 2 Symbol Type = Upper Alpha>
<!Autonumber Stream, App_List, 4,
Level 1 Symbol Type = Upper Alpha>
<!Autonumber Stream, List, 4>
<!Autonumber Stream, NList, 4>
<!Class, appendix,
Line Spacing = 1.179 lines,
Alignment = Left,
Font = F101,
Begin New Page = yes,
Contents = Prefix>
<"|:appendix",
Hidden = yes,
Font = @i*,
Subcomponent = yes,
Contents = Shared><F0><Autonum, App_List, 1><End Sub><F0>
<!Class, center,
Top Margin = 0.14 inches,
Bottom Margin = 0 inches,
Line Spacing = 1.308 lines,
Alignment = Center,
Font = F57,
Left Tab = 0.50/0.50*29 Inches>
<!Class, cont_line,
Bottom Margin = 0.50 inches,
Left Margin = 1 inches,
Right Margin = 1 inches,
Line Spacing = 1.179 lines,
Alignment = Left,
Font = F93>
<!Class, Contents,
Line Spacing = 1.179 lines,
Alignment = Center,
Font = F101,
Begin New Page = yes>
<!Class, justified,
Top Margin = 0.14 inches,
Bottom Margin = 0 inches,
Line Spacing = 1.308 lines,
Font = F40,
Left Tab = 0.50/0.50*29 Inches>
<!Class, left,
Top Margin = 0.14 inches,
Bottom Margin = 0 inches,
Line Spacing = 1.308 lines,
Alignment = Left,
Font = F40,
Left Tab = 0.50/0.50*29 Inches>
<!Class, right,
Top Margin = 0.14 inches,
Bottom Margin = 0 inches,
Line Spacing = 1.308 lines,
Alignment = Right,
Font = F40,
Left Tab = 0.50/0.50*29 Inches>
<!Class, title_line,
Line Spacing = 1.179 lines,
Alignment = Center,
Font = F97>
<!Class, "|:appendix",
Top Margin = 0.04 inches,
Bottom Margin = 0.04 inches,
Line Spacing = 1.162 lines,
Font = F101@i*,
Left Tab = 0/1*3 Inches,
Composition = Optimum,
Contents = Shared>
<Autonum, App_List, 1>
<!Class, "|:capability",
Top Margin = 0.04 inches,
Bottom Margin = 0.04 inches,
Line Spacing = 1.162 lines,
Font = F97@i*,
Left Tab = 0/1*3 Inches,
Composition = Optimum,
Contents = Shared>
<Autonum, List, 3>
<!Class, "|:list",
Top Margin = 0.04 inches,
Bottom Margin = 0.04 inches,
Line Spacing = 1.162 lines,
Font = F84@i*,
Left Tab = 0/1*3 Inches,
Composition = Optimum,
Contents = Shared>
<Autonum, NList, 1>
<!Class, "|:section",
Top Margin = 0.04 inches,
Bottom Margin = 0.04 inches,
Line Spacing = 1.162 lines,
Font = F101@i*,
Left Tab = 0/1*3 Inches,
Composition = Optimum,
Contents = Shared>
<Autonum, List, 1>
<!Class, "|:subcapability",
Top Margin = 0.04 inches,
Bottom Margin = 0.04 inches,
Line Spacing = 1.162 lines,
Font = F97@i*,
Left Tab = 0/1*3 Inches,
Composition = Optimum,
Contents = Shared>
<Autonum, List, 4>
<!Class, "|:subsection",
Top Margin = 0.04 inches,
Bottom Margin = 0.04 inches,
Line Spacing = 1.162 lines,
Font = F97@i*,
Left Tab = 0/1*3 Inches,
Composition = Optimum,
Contents = Shared>
<Autonum, List, 2>
<!Class, "|:subsubsection",
Top Margin = 0.04 inches,
Bottom Margin = 0.04 inches,
Line Spacing = 1.162 lines,
Font = F97@i*,
Left Tab = 0/1*3 Inches,
Composition = Optimum,
Contents = Shared>
<Autonum, List, 3>
<!Class, LRM_Name,
Line Spacing = 1.179 lines,
Alignment = Left,
Font = F40@iL@iS@iU@iR@iT@iB@iP@iK@iC@iZ@iO,
Left Tab = 0.50/1.50 Inches,
Contents = Shared>
Ada LRM Reader
<!Class, capability,
Top Margin = 0.28 inches,
Line Spacing = 1.179 lines,
Alignment = Left,
Font = F97,
Orphan Control = 5,
Widow Control = 5,
Allow Page Break After = no,
TOC Doc Name = "SUM Toc",
Contents = Prefix>
<"|:capability",
Hidden = yes,
Font = @i*,
Subcomponent = yes,
Contents = Shared><F0><Autonum, List, 3><End Sub><F0>3.2.<Autonum, List, 1>
[Capability name]
<!Class, codepara,
Left Margin = 0.50 inches,
Line Spacing = 1.179 lines,
Alignment = Left,
Font = F22>
<!Class, list,
Left Margin = 0.50 inches,
First Indent = -0.25 inches,
Line Spacing = 1.179 lines,
Alignment = Left,
Font = F84,
Left Tab = 0.50/1.50 Inches,
Contents = Prefix>
<"|:list",
Hidden = yes,
Font = @i*,
Subcomponent = yes,
Contents = Shared><F0><Autonum, NList, 1><End Sub><F0>
<!Class, paragraph,
Line Spacing = 1.179 lines,
Font = F84>
<!Class, section,
Line Spacing = 1.179 lines,
Alignment = Left,
Font = F101,
Begin New Page = yes,
TOC Doc Name = "SUM Toc",
Contents = Prefix>
<"|:section",
Hidden = yes,
Font = @i*,
Subcomponent = yes,
Contents = Shared><F0><Autonum, List, 1><End Sub><F0>
<!Class, subcapability,
Top Margin = 0.28 inches,
Line Spacing = 1.179 lines,
Alignment = Left,
Font = F97,
Orphan Control = 5,
Widow Control = 5,
Allow Page Break After = no,
TOC Doc Name = "SUM Toc",
Contents = Prefix>
<"|:subcapability",
Hidden = yes,
Font = @i*,
Subcomponent = yes,
Contents = Shared><F0><Autonum, List, 4><End Sub><F0>
<!Class, subsection,
Line Spacing = 1.179 lines,
Alignment = Left,
Font = F97,
TOC Doc Name = "SUM Toc",
Contents = Prefix>
<"|:subsection",
Hidden = yes,
Font = @i*,
Subcomponent = yes,
Contents = Shared><F0><Autonum, List, 2><End Sub><F0>
<!Class, subsubsection,
Top Margin = 0.28 inches,
Line Spacing = 1.179 lines,
Alignment = Left,
Font = F97,
Orphan Control = 5,
Widow Control = 5,
Allow Page Break After = no,
TOC Doc Name = "SUM Toc",
Contents = Prefix>
<"|:subsubsection",
Hidden = yes,
Font = @i*,
Subcomponent = yes,
Contents = Shared><F0><Autonum, List, 3><End Sub><F0>
<!Master Frame,
Name = "At Anchor",
Placement = At Anchor,
Width = 0.41 inches,
Height = 0.14 inches,
Diagram =
V6,
(g9,0,0)>
<!Master Frame,
Name = Bottom,
Placement = Bottom of Page,
Horizontal Alignment = Center,
Width = 6.50 inches,
Height = 3.25 inches,
Diagram =
V6,
(g9,0,0)>
<!Master Frame,
Name = Footnote,
Placement = Bottom of Page,
Horizontal Alignment = Left,
Same Page = yes,
Width = 6.50 inches,
Height = 0.20 inches,
Diagram =
V6,
(g9,0,0)>
<!Master Frame,
Name = Top,
Placement = Top of Page,
Horizontal Alignment = Center,
Width = 6.50 inches,
Height = 3.25 inches,
Diagram =
V6,
(g9,0,0)>
<!Master Frame,
Name = "Following Anchor",
Placement = Following Anchor,
Horizontal Alignment = Center,
Width = 6.50 inches,
Height = 3.25 inches,
Diagram =
V6,
(g9,0,0)>
<!Master Frame,
Name = "Following Text",
Placement = Following Text,
Horizontal Alignment = Center,
Width = 6.50 inches,
Height = 3.25 inches,
Diagram =
V6,
(g9,0,0)>
<Page Header, Frame =
V6,
(g9,1,0
(T12,1,12,3,0.4,7,127,5,7,127,8,0,2,
<!Page, Width = 0.467 inches, Height = 0.193 inches>
<paragraph,
Font = F97>
SUM
<End Text>)
(t14,2,0,0.133333,0.8,0,7,0,0,,wst:swiss14b,Ada\ LRM\ READER)
(t14,3,0,5,0.8,0,7,0,0,,wst:swiss14b,Richard\ Conn))>
<Page Footer, Frame =
V6,
(g9,1,0
(t14,1,0,3.066667,0.333333,1,7,0,0,,wst:swiss14b,\X80a0))>
<section>
<|,1><"|:section", Subcomponent = yes><F0><Autonum, List, 1, First = Yes, Value = 1.><End Sub>
<F0> Scope
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The <LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>
is a tool for browsing through an online copy of the Ada Language
Reference Manual (LRM). This tool allows a user to interactively
view the Ada LRM, search for strings, and move through the Ada LRM
with ease. Ease of human interface is a chief concern.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The target user is assumed to have a VT100-style display terminal
or VT100 emulation capabilities. The user will be using this tool
in one of several modes:
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, First = Yes, Restart = Yes, Value = 1.><End Sub>
<F0> As a user on a UNIX workstation running in a VT100 emulator window,
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 2.><End Sub>
<F0> As a user accessing a UNIX workstation remotely, also running
a VT100 or VT100 emulator on a PC, and
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 3.><End Sub>
<F0> As a user on a PC running the Ada LRM Reader on the PC.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The <LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>
is a single program written in Ada and will be considered to be a
single CSCI. This CSCI includes:
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Restart = Yes, Value = 1.><End Sub>
<F0> The source code, in Ada, of the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0>
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 2.><End Sub>
<F0> All data files needed by the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0>
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 3.><End Sub>
<F0> All source files and programs used to create the data files needed
by the <LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 4.><End Sub>
<F0> All documentation associated with the <LRM_Name, Subcomponent = yes><F40>A
da LRM Reader<End Sub><F0>
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 5.><End Sub>
<F0> Installation instructions for compiling the setting up the
<LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0> for
a PC or UNIX platform
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 6.><End Sub>
<F0> A complete executable version of the <LRM_Name, Subcomponent = yes><F40>Ad
a LRM Reader<End Sub><F0> with its associated data files and installation
instructions which is ready to run on a PC under MSDOS 3.3 or higher
<section>
<|,2><"|:section", Subcomponent = yes><F0><Autonum, List, 1, Value = 2.><End Sub>
<F0> References
<subsection>
<"|:subsection", Subcomponent = yes><F0><Autonum, List, 2, Value = 2.1.><End Sub>
<F0> Documents
<paragraph>
Conn, Richard, <F85>Software Requirements Specification for the
<LRM_Name,
Font = F41@iL@iS@iU@iR@iT@iB@iP@iK@iC@iZ@iO,
Subcomponent = yes><F41>Ada LRM Reader<End Sub><F0>, University
of Cincinnati, Department of Electrical and Computer Engineering,
Mail Location 30, Cincinnati, Ohio 45221<HR>
<HR>
This document contains other references which may be useful.<HR>
<HR>
Conn, Richard, <F85>Software Design Document for the
<LRM_Name,
Font = F41@iL@iS@iU@iR@iT@iB@iP@iK@iC@iZ@iO,
Subcomponent = yes><F41>Ada LRM Reader<End Sub><F0>, University
of Cincinnati, Department of Electrical and Computer Engineering,
Mail Location 30, Cincinnati, Ohio 45221<HR>
<subsection>
<"|:subsection", Subcomponent = yes><F0><Autonum, List, 2, Value = 2.2.><End Sub>
<F0> Terminology
<paragraph>
The following application-specific terms are defined below in order
to better follow this document:
<paragraph>
<F93>Citation<F0> - A body of text in the Ada LRM or an LRM Support
File which is uniquely identified by a numeric reference or a keyword
(these are called citation labels). For example, the citation identified
by 4 is:
<codepara>
4. Names and Expressions<HR>
<HR>
<HR>
The rules applicable to the different forms of name and expression,
and<HR>
to their evaluation, are given in this chapter.
<paragraph,
Left Tab = 0/1/1.50/0.75*27 Inches>
<F93>Citation Label<F0> - A numeric reference or a keyword which identifies
a citation. For example, 4 is the citation label for the above citation.
Valid citation labels take the following forms:<HR>
<HR>
<F86>Label<Tab>Refers to<F0><HR>
n<Tab>Chapter (1-14)<HR>
n.n<Tab>Chapter and Section<HR>
n.n.n<Tab>Chapter, Section, and Subsection<HR>
letter<Tab>Appendix (A-F)<HR>
CONTENTS<Tab>Table of Contents<HR>
INDEX<Tab>Index<HR>
FOREWARD<Tab>Foreward<HR>
POSTSCRIPT<Tab>Postscript<HR>
HELP<Tab>Online help screens for the Ada LRM Reader<HR>
ABOUT<Tab>Online program description of the Ada LRM Reader
<paragraph>
<F93>Citation ID<F0> - An alphabetic reference used in the CITATION_ID
enumeration type which maps to a citation label. Citation IDs are
discussed in the Software Design Document for the Ada LRM Reader.
Each citation label has one and only one citation ID.
<section>
<|,3><"|:section", Subcomponent = yes><F0><Autonum, List, 1, Value = 3.><End Sub>
<F0> Quick start
<paragraph>
This section of the Software User's Manual is designed to quickly
introduce the user to the <LRM_Name, Subcomponent = yes><F40>Ada LRM
Reader<End Sub><F0>. It is not a complete introduction to all of
the features, but it will get you up and running in a very short time.
<paragraph>
The text below assumes that the name of the executable to invoke the
<LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0> is:
<paragraph,
Alignment = Center,
Font = F93>
lrm
<paragraph>
The text below presents commands for you to type in a distinctly different
font. Try running the <LRM_Name, Subcomponent = yes><F40>Ada LRM
Reader<End Sub><F0> as you are reading this section of the SUM and
typing the commands as they are presented. For example, if you see:
<codepara>
lrm<<cr>
<paragraph>
you should type the letters l, r, and m and then strike the RETURN
key (<<cr> is a symbol for the RETURN key). If you make a mistake,
the command line editor for your particular system is being used,
so you may use your normal editing commands to fix errors (such as
the BACKSPACE or DELETE key to delete the previous character typed).
<subsection>
<"|:subsection", Subcomponent = yes><F0><Autonum, List, 2, Value = 3.1.><End Sub>
<F0> Getting into and out of the Ada LRM Reader
<paragraph>
Issue the command:
<codepara>
lrm<<cr>
<paragraph>
You show be looking at the first screen of the online help citation
of the <LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>.
There are currently only two screens. Try the following:
<codepara>
<<cr><HR>
p<<cr>
<paragraph>
The "<<cr>" advanced you to the next screen (2 of 2), and the "p<<cr>"
backed you up to the previous screen (1 of 2). You may also try the
following:
<codepara>
n<<cr><HR>
p<<cr>
<paragraph>
These commands did the same thing. The command "n<<cr>" or just "<<cr>"
are equivalent, advancing you to the next screen. Now try the command:
<codepara>
quit<<cr>
<paragraph>
This gets you out of the program.
<subsection>
<"|:subsection", Subcomponent = yes><F0><Autonum, List, 2, Value = 3.2.><End Sub>
<F0> A tour
<paragraph>
Try the following commands:
<codepara>
lrm contents<<cr><HR>
<<cr><HR>
<<cr><HR>
p<<cr><HR>
p<<cr>
<paragraph>
By specifying the citation "contents" on the command line, the
<LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0> starts
at that point. You have looked at the beginning of the table of contents
(first three screens) and then backed up to the first screen. Now
try this:
<codepara>
<|,4>p<<cr>
<paragraph>
Note that you did not move and an error message appeared. You attempted
to move in front of a citation which has no preceding citation. The
citations HELP, ABOUT, CONTENTS, INDEX, FOREWARD, and POSTSCRIPT are
isolated and have no preceding or following citations. However, if
you do this:
<codepara>
4.1<<cr><HR>
p<<cr><HR>
p<<cr>
<paragraph>
you will have jumped to citation 4.1 (screen 1 of 4), backed up to
4 (screen 1 of 1), and then backed up again to 3.9 (screen 4 of 4).
Likewise, if you now do this:
<codepara>
<<cr><HR>
<<cr><HR>
<<cr>
<paragraph>
you will have advanced forward to citation 4.1 (screen 2 of 4). Now
try this:
<codepara>
next<<cr><HR>
next<<cr><HR>
previous<<cr><HR>
previous<<cr>
<paragraph>
The longer "next" and "previous" commands move a citation at a time
rather than a screen at a time. Note that you move to 4.1.1 and 4.1.2,
and then back to 4.1.1 and 4.1. Of course, you can still always jump
around to where you want to go:
<codepara>
c<<cr><HR>
a<<cr><HR>
previous<<cr>
<paragraph>
jumps you to Appendix C (screen 1 of 14), Appendix A (Screen 1 of
22), and 14.7 (Screen 1 of 3). Appendices A to F follow Chapter 14.
Note that if you type this:
<codepara>
f<<cr><HR>
<<cr><HR>
<<cr>
<paragraph>
you will advance to Appendix F (Screen 1 of 2), and then try to advance
to the screen beyond Appendix F. An error message appears indicating
that the <LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>
cannot advance further. Likewise, typing:
<codepara>
1<<cr><HR>
p<<cr>
<paragraph>
jumps you to Chapter 1 (Screen 1 of 1) and then trys to back up before
this screen, again resulting in an error message. Now try the following:
<codepara>
9.7<<cr><HR>
push 9.7.2<<cr><HR>
<<cr><HR>
pop
<paragraph>
This jumps you to 9.7, pushes your location onto the location stack
and jumps to 9.7.2 (Screen 1 of 3), advances to 9.7.2 (Screen 2 of
3), and then pops the location stack, placing you back at 9.7 (Screen
1 of 1). Note also that the prompt changed while you were in 9.7.2
from 1/ to 2/, indicating that you were on the 2nd element of the
location stack. You might want to try this again to note the changes
in the prompt. For your convenience, the location stack is 20 levels
deep. Often, when we are reading in the Ada LRM, we find references
to other
<|,5>citations, as in this case, if you note the references on 9.7
(Screen 1 of 1). The "push" and "pop" commands allow us to jump from
where we are to the reference, placing a "bookmark" in our old location,
and then jump back to where we were. Now try this:
<codepara>
push index<<cr><HR>
/wait<<cr>
<paragraph>
Note that this caused you to jump into the INDEX of the Ada LRM and
find the first occurrence of the string "wait". Look carefully at
the little "<<" on the far right -- it indicates the line on which
the string was found. Now try:
<codepara>
//<<cr><HR>
//<<cr>
<paragraph>
You have continued your search twice. This shows you that block statements
may include selective waits, so you may read 9.7.1 to look into it.
Try this:
<codepara>
push 9.7.1<<cr>
<paragraph>
You now find yourself in 9.7.1 on level 3 of the location stack.
To get back to where you started, try this to move through the index
location to 9.7:
<codepara>
pop<<cr><HR>
pop<<cr><HR>
pop<<cr>
<paragraph>
Caught you! Note that I gave you one too many "pop" commands. If
you try to "pop" too far, the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0> simply catches you with an error message.
As our last experiment, try the following:
<codepara>
help<<cr>
<paragraph>
Note that, unlike the other citation references, the "help" command
automatically performs a "push". Look at the various commands and
the notes on the prompt line presented here and experiment as you
desire. Be sure to try the "about" command. When you are done, issue
the "quit" command to exit.
<section>
<|,6><"|:section", Subcomponent = yes><F0><Autonum, List, 1, Value = 4.><End Sub>
<F0> Reference Manual - Execution procedures
<subsection>
<"|:subsection", Subcomponent = yes><F0><Autonum, List, 2, Tagname = MNiwf33econn, Value = 4.1.><End Sub>
<F0>Initialization
<paragraph>
The <LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>
is invoked in two ways:
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Restart = Yes, Value = 1.><End Sub>
<F0>The command "lrm" with no arguments invokes the
<LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0> in
such a way that the help screen comes up. The user may then read
the help screen or enter a command or citation at this point.
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 2.><End Sub>
<F0> The command "lrm citation" invokes the <LRM_Name, Subcomponent = yes>
<F40>Ada LRM Reader<End Sub><F0> in such a way that the indicated
citation is displayed initially.
<paragraph>
See Section <Ref, Auto #, Value = 4.2.1.1., Tag = DZiwf3deconn> for
the definition of a citation.
<subsection>
<"|:subsection", Subcomponent = yes><F0><Autonum, List, 2, Tagname = fOiwf2c6conn, Value = 4.2.><End Sub>
<F0>User inputs
<paragraph>
The following table summarizes the commands the user may give to the
program. This is done interactively.<HR>
<HR>
<<Citation><Tab><Tab>Jump to the indicated citation<HR>
N or <<CR><Tab>Advance to the next screen or citation<HR>
P<Tab><Tab>Back up to the previous screen or citation<HR>
NEXT<Tab><Tab>Advance to the next citation, first screen<HR>
PREVIOUS<Tab><Tab>Back up to the previous citation, first screen<HR>
PUSH <<Citation><Tab>Jump to the indicated citation, saving the current
location on the location stack<HR>
POP<Tab><Tab>Return to the location at the top of the location stack <HR>
PRINT<Tab><Tab>Print the current citation to a log file<HR>
PS<Tab><Tab>Print the current screen to a log file<HR>
REFRESH<Tab><Tab>Redisplay the current screen<HR>
PAUSE<Tab><Tab>Delay for about 5 seconds<HR>
/[<<string>]<Tab><Tab>Search for the optional string from the beginning
of the current citation<HR>
//[<<string>]<Tab>Search for the optional string from the next line<HR>
HELP<Tab><Tab>Push into the help screen<HR>
ABOUT<Tab><Tab>Display information about the <LRM_Name, Subcomponent = yes>
<F40>Ada LRM Reader<End Sub><F0><HR>
QUIT<Tab><Tab>Exit the <LRM_Name, Subcomponent = yes><F40>Ada LRM
Reader<End Sub><F0>
<paragraph>
See Section <Ref, Auto #, Value = 4.2.1.1., Tag = DZiwf3deconn> for
the definition of a citation.
<capability>
<"|:capability", Subcomponent = yes><F0><Autonum, List, 3, Value = 4.2.1.><End Sub>
<F0> Display citations
<subcapability>
<"|:subcapability", Subcomponent = yes><F0>
<Autonum, List, 4, Tagname = DZiwf3deconn, Value = 4.2.1.1.><End Sub><F0>
Command: <<Citation> - Jump to a citation
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
A citation in the Ada LRM is accessed by the user simply typing its
identifying name, such as 1 for Chapter 1, 4.1 for Section 1 of Chapter
4, 11.4.1 for Subsection 1 of Section 4 of Chapter 11, A for appendix
A, CONTENTS for the table of contents, INDEX for the index, and FOREWARD
for the foreward.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
Valid citations are:
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Restart = Yes, Value = 1.><End Sub>
<F0> n<Tab><Tab>Chapter number, such as 1 to 14
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 2.><End Sub>
<F0> n.n<Tab><Tab>Chapter and section number, such as 4.2
<list>
<|,7><"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 3.><End Sub>
<F0> n.n.n<Tab><Tab>Chapter, section, and subsection number, such
as 11.4.2
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 4.><End Sub>
<F0> l<Tab><Tab>Appendix letter, such as a to f or A to F
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 5.><End Sub>
<F0> CONTENTS<Tab>Table of contents
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 6.><End Sub>
<F0> INDEX<Tab><Tab>Index
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 7.><End Sub>
<F0> FOREWARD<Tab>Foreward
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 8.><End Sub>
<F0> POSTSCRIPT<Tab>Postscript
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 9.><End Sub>
<F0> HELP<Tab><Tab>Online help display
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 10.><End Sub>
<F0> ABOUT<Tab><Tab>Information about the Ada LRM Reader program
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
Citations may be used in two places: as a command themselves, which
causes the <LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>
to jump to that citation, or as an argument to the PUSH command, which
causes the Ada LRM Reader to push the location of the current citation
onto a stack and then jump to the indicated citation. The POP command
may be used to return to the citation displayed at the time the PUSH
command was issued.
<capability>
<"|:capability", Subcomponent = yes><F0><Autonum, List, 3, Value = 4.2.2.><End Sub>
<F0> Print citations
<subcapability>
<"|:subcapability", Subcomponent = yes><F0>
<Autonum, List, 4, Tagname = "xHJ@f352conn", Value = 4.2.2.1.><End Sub><F0>
Command: PRINT - Print the current citation
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The PRINT command prints the current citation, as ASCII text, to a
log file named LRM.LOG. Subsequent PRINT and PS (see next paragraph)
commands append to the end of this log file. The log file is closed
and available for review and printing when the user exits the
<LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0> via
the QUIT command.
<subcapability>
<"|:subcapability", Subcomponent = yes><F0>
<Autonum, List, 4, Tagname = "MIJ@f366conn", Value = 4.2.2.2.><End Sub><F0>
Command: PS - Print the current screen
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The PS command prints the current screen of the citation, as ASCII
text, to a log file named LRM.LOG. Subsequent PRINT and PS commands
append to the end of this log file. The log file is closed and available
for review and printing when the user exits the
<LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0> via
the QUIT command.
<capability>
<"|:capability", Subcomponent = yes><F0><Autonum, List, 3, Value = 4.2.3.><End Sub>
<F0> Movement within and between citations
<subcapability>
<"|:subcapability", Subcomponent = yes><F0>
<Autonum, List, 4, Tagname = Eymwf37aconn, Value = 4.2.3.1.><End Sub><F0>
Command: N or <<CR> - Next screen
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The N command or a line containing only a RETURN (<<CR>) commands
the <LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>
to advance to the next screen. If the current screen is the last
screen of a citation, the user is advanced to the first screen of
the next citation. If the current citation is the last citation in
the LRM, an error message will be displayed and the user will stay
on the current screen.
<subcapability>
<"|:subcapability", Subcomponent = yes><F0>
<Autonum, List, 4, Tagname = uzmwf2c6conn, Value = 4.2.3.2.><End Sub><F0>
Command: P - Previous screen
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The P command commands the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0> to back up to the previous screen. If the
current screen is the first screen of a citation, the user is backed
up to the last screen of the previous citation. If the cur
<|,8>rent citation is the first citation in the LRM, an error message
will be displayed and the user will stay on the current screen.
<subcapability>
<"|:subcapability", Subcomponent = yes><F0>
<Autonum, List, 4, Tagname = "E@mwf172conn", Value = 4.2.3.3.><End Sub><F0>
Command: NEXT - Next citation
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The NEXT command commands the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0> to advance to the first screen of the next
citation. If the current citation is the last citation in the LRM,
an error message will be displayed and the user will stay on the current
screen.
<subcapability>
<"|:subcapability", Subcomponent = yes><F0>
<Autonum, List, 4, Tagname = "s@mwf33econn", Value = 4.2.3.4.><End Sub><F0>
Command: PREVIOUS - Previous citation
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The PREVIOUS command commands the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0> to back up to the first screen of the previous
citation. If the current citation is the first citation in the LRM,
an error message will be displayed and the user will stay on the current
screen.
<subcapability>
<"|:subcapability", Subcomponent = yes><F0>
<Autonum, List, 4, Tagname = P1nwfbeconn, Value = 4.2.3.5.><End Sub><F0>
Command: PUSH <<citation> - Save location and jump
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The PUSH command commands the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0> to save the user's current location (citation
and screen) on a location stack and to then jump to the indicated
citation. A subsequent POP command will place the user back into
the citation and screen last saved on the stack.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
If the location stack is full, an error message will be displayed
and the user will stay on the current screen.
<subcapability>
<"|:subcapability", Subcomponent = yes><F0>
<Autonum, List, 4, Tagname = i3nwf1eaconn, Value = 4.2.3.6.><End Sub><F0>
Command: POP - Return to saved location
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The POP command commands the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0> to jump to the citation and screen currently
stored at the top of the location stack.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
If the location stack is empty, an error message will be displayed
and the user will stay on the current screen.
<capability>
<"|:capability", Subcomponent = yes><F0><Autonum, List, 3, Value = 4.2.4.><End Sub>
<F0> String searches
<subcapability>
<"|:subcapability", Subcomponent = yes><F0>
<Autonum, List, 4, Tagname = L7nwf1econn, Value = 4.2.4.1.><End Sub><F0>
Command: /[<<string>] - String Search from Beginning of Citation
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The / command causes the <LRM_Name, Subcomponent = yes><F40>Ada LRM
Reader<End Sub><F0> to search for the indicated string from the beginning
of the current citation. The string argument starts immediately after
the slash, so a space after the slash, for instance, is the first
character of the search string. Spaces may be embedded in the search
string as required. The search is not case-sensitive.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
This command is convenient for searching through the larger citations,
such as the Index, Appendix E (the syntax appendix), or one of the
other appendices.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
<|,9>The string argument in this command is optional. If omitted,
the last string looked for is used. If the string argument is omitted
and there was no last string, an error message is displayed.
<subcapability>
<"|:subcapability", Subcomponent = yes><F0>
<Autonum, List, 4, Tagname = o7nwf276conn, Value = 4.2.4.2.><End Sub><F0>
Command: //[<<string>] - String Search from Next Line of Citation
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The // command causes the <LRM_Name, Subcomponent = yes><F40>Ada LRM
Reader<End Sub><F0> to search for the indicated string from the beginning
of the next line in the current citation. The string argument starts
immediately after the second slash, so a space after the second slash,
for instance, is the first character of the search string. Spaces
may be embedded in the search string as required. The search is not
case-sensitive.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
This command is intended to be used to allow the user to resume searching
from where the / command left off.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The string argument in this command is optional. If omitted, the
last string looked for is used. If the string argument is omitted
and there was no last string, an error message is displayed.
<capability>
<"|:capability", Subcomponent = yes><F0><Autonum, List, 3, Value = 4.2.5.><End Sub>
<F0> Other capabilities
<subcapability>
<"|:subcapability", Subcomponent = yes><F0><Autonum, List, 4, Value = 4.2.5.1.><End Sub>
<F0> Command: REFRESH - Redisplay current screen
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The REFRESH command commands the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0> to redisplay the current screen of the current
citation.
<subcapability>
<"|:subcapability", Subcomponent = yes><F0><Autonum, List, 4, Value = 4.2.5.2.><End Sub>
<F0> Command: PAUSE - Delay for about 5 seconds
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The PAUSE command causes the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0> to delay execution for about 5 seconds.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
This command is useful when testing the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0> via a batch command file redirected to standard
input.
<subcapability>
<"|:subcapability", Subcomponent = yes><F0><Autonum, List, 4, Value = 4.2.5.3.><End Sub>
<F0> Command: HELP - Display online help
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The HELP command commands the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0> to push into the help screen from the current
citation. This allows the user to easily return to where he was when
he issued the HELP command by simply issuing a POP command.
<subcapability>
<"|:subcapability", Subcomponent = yes><F0><Autonum, List, 4, Value = 4.2.5.4.><End Sub>
<F0> Command: ABOUT - Display information about the program
<paragraph>
The ABOUT command displays information about the
<LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>, including
information on how to contact the author and the maintainer. Distribution
rights are also presented on this screen.
<subcapability>
<"|:subcapability", Subcomponent = yes><F0>
<Autonum, List, 4, Tagname = QUIT_Command, Value = 4.2.5.5.><End Sub><F0>
Command: QUIT - Exit the program
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The QUIT command commands the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0> to exit, returning to the shell from which
it was invoked. If any PRINT or PS commands were issued, the log
file is closed. If any citation files are currently open, they are
closed.
<capability>
<|,10><"|:capability", Subcomponent = yes><F0>
<Autonum, List, 3, Tagname = kxmwf276conn, Value = 4.2.6.><End Sub><F0>
Invalid Commands
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
If the user types a command which is not a citation or one of the
commands listed above, an error message will appear.
<subsection>
<"|:subsection", Subcomponent = yes><F0><Autonum, List, 2, Value = 4.3.><End Sub>
<F0>System inputs
<paragraph>
The command line argument is the only input from the system accepted
by the <LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>.
Other system inputs, such as environment variables, are not accepted.
<subsection>
<"|:subsection", Subcomponent = yes><F0><Autonum, List, 2, Value = 4.4.><End Sub>
<F0>Termination
<paragraph>
Execution of this program is terminated by the user entering the QUIT
command, described in Section <Ref, Auto #, Value = 4.2.5.5., Tag = QUIT_Command>
<subsection>
<"|:subsection", Subcomponent = yes><F0><Autonum, List, 2, Value = 4.5.><End Sub>
<F0>Restart
<paragraph>
The procedure for restarting this program is the same as for starting
it from scratch. See Section <Ref, Auto #, Value = 4.1., Tag = MNiwf33econn>
<subsection>
<"|:subsection", Subcomponent = yes><F0><Autonum, List, 2, Value = 4.6.><End Sub>
<F0>Outputs
<paragraph>
Error messages are described in Section <Ref, Auto #, Value = 5., Tag = o6Nxf334conn>
The command descriptions and details on their outputs are in Section <Ref, Auto #, Value = 4.2., Tag = fOiwf2c6conn>
The following shows the key screen displays and discusses their meanings.
<subsubsection>
<"|:subsubsection", Subcomponent = yes><F0><Autonum, List, 3, Value = 4.6.1.><End Sub>
<F0> Normal Screen Displays
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
Each display to the user resembles the following:<HR>
<Frame,
Name = "Following Anchor",
Placement = At Anchor,
Width = 6.50 inches,
Height = 4 inches,
Diagram =
V6,
(g9,2,0
(p8,2,8,5,7,127
(g9,2,0
(g9,2,0
(v6,2,65536,0.266667,0.333333,6.2,0.333333,7,0,8,0)
(v6,3,65536,6.2,0.333333,6.2,3.733333,7,0,8,0)
(v6,4,65536,6.2,3.733333,0.266667,3.733333,7,0,8,0)
(v6,5,65536,0.266667,3.733333,0.266667,0.333333,7,0,8,0))))
(t14,6,0,0.6,0.733333,0,7,0,0,,wst:swiss10,Text\ of\ screen\ currently\ being\
displayed)
(t14,7,0,0.4,3.466667,0,7,0,0,,wst:swiss10,Cit:\ Stack/\ n\ of\ m\ --\ Ada\ LRM
\ Reader\ n.n\ Command:)
(t14,8,0,3.666667,1.733333,0,7,0,0,,wst:swiss10,22\ lines\ of\ text\ by\ 75\ co
lumns)
(v6,9,0,4.533333,1.466667,4.533333,0.333333,7,0,8,0)
(v6,12,0,4.533333,1.866667,4.533333,3.266667,7,0,8,0)
(t14,15,0,2.666667,3.666667,0,7,0,0,,wst:swiss10,Error\ Message\ Line)
(v6,16,0,3.866667,3.6,6.133333,3.6,7,0,8,0)
(v6,17,0,2.6,3.6,0.266667,3.6,7,0,8,0)
(t14,18,0,0.733333,2.333333,0,7,0,0,,wst:swiss10,This\ is\ a\ very\ long\ line\
of\ text\ which\ will\ wrap\ to\ the\ next\ line\,\ showing\ the\ continuat)
(t14,19,0,0.266667,2.533333,0,7,0,0,,wst:swiss10,|\ ion\ mark\ \(which\ is\ a\
vertical\ bar\ in\ the\ first\ column\).)
(g9,88,8
(v6,88,0,4.533333,3.266667,4.533333,3.066667,7,0,8,0)
(g9,90,1025
(p8,90,0,5,7,0
(g9,90,0
(g9,90,0
(v6,90,0,4.478608,3.116314,4.533333,3.266667,7,0,8,0)
(v6,91,0,4.533333,3.266667,4.588056,3.116314,7,0,8,0)
(v6,92,0,4.588056,3.116314,4.533333,3.148389,7,0,8,0)
(v6,93,0,4.533333,3.148389,4.478608,3.116314,7,0,8,0))))
(v6,94,25167905,4.533333,3.266667,4.533333,3.266667,7,127,8,0)))
(g9,95,8
(v6,95,0,4.533333,0.333333,4.533333,0.533333,7,0,8,0)
(g9,97,1025
(p8,97,0,5,7,0
(g9,97,0
(g9,97,0
(v6,97,0,4.588057,0.483686,4.533333,0.333333,7,0,8,0)
(v6,98,0,4.533333,0.333333,4.478609,0.483686,7,0,8,0)
(v6,99,0,4.478609,0.483686,4.533333,0.451611,7,0,8,0)
(v6,100,0,4.533333,0.451611,4.588057,0.483686,7,0,8,0))))
(v6,101,25167905,4.533333,0.333333,4.533333,0.333333,7,127,8,0)))
(g9,102,8
(v6,102,0,0.266667,3.6,0.466667,3.6,7,0,8,0)
(g9,104,1025
(p8,104,0,5,7,0
(g9,104,0
(g9,104,0
(v6,104,0,0.417019,3.545275,0.266667,3.6,7,0,8,0)
(v6,105,0,0.266667,3.6,0.417019,3.654723,7,0,8,0)
(v6,106,0,0.417019,3.654723,0.384945,3.6,7,0,8,0)
(v6,107,0,0.384945,3.6,0.417019,3.545275,7,0,8,0))))
(v6,108,25167905,0.266667,3.6,0.266667,3.6,7,127,8,0)))
(g9,109,8
(v6,109,0,6.2,3.6,6,3.6,7,0,8,0)
(g9,111,1025
(p8,111,0,5,7,0
(g9,111,0
(g9,111,0
(v6,111,0,6.049648,3.654725,6.2,3.6,7,0,8,0)
(v6,112,0,6.2,3.6,6.049648,3.545277,7,0,8,0)
(v6,113,0,6.049648,3.545277,6.081722,3.6,7,0,8,0)
(v6,114,0,6.081722,3.6,6.049648,3.654725,7,0,8,0))))
(v6,115,25167905,6.2,3.6,6.2,3.6,7,127,8,0))))>
<HR>
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
<|,11>The above display is divided into three areas:
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Restart = Yes, Value = 1.><End Sub>
<F0>an area for the text to be displayed (lines 1 to 22),
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 2.><End Sub>
<F0>a command prompt and input line (line 23), and
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 3.><End Sub>
<F0>an error message line (line 24).
<paragraph>
The text area contains the text of the current citation. The 75-column
(max) lines are indented two spaces on the left and three spaces on
the right. If a line of the text is longer than 75 columns, it is
continued on the next line, where a vertical bar (|) appears in the
first column followed by a space and the remainder of the line.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The command prompt indicates the citation currently being displayed,
the number of levels deep the user is on the location stack, the number
of the current screen in the citation, and the total number of screens
in the citation.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The error message line shall be blank most of the time; it shall contain
an error message when the previous command resulted in one.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
Commands are entered after the command prompt by the user. These
commands may be edited via the standard command line editor for the
target system. The commands will be processed by the system when
the user strikes the RETURN (<<CR>) key.
<subsubsection>
<"|:subsubsection", Subcomponent = yes><F0><Autonum, List, 3, Value = 4.6.2.><End Sub>
<F0> Screen Displays when in Search Mode
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
When the <LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>
is in a search mode (one of the two search commands has been issued),
the display shall change to that indicated below:<HR>
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
<Frame,
Name = "Following Text",
Placement = At Anchor,
Width = 6.50 inches,
Height = 4 inches,
Diagram =
V6,
(g9,2,0
(p8,2,8,5,7,127
(g9,2,0
(g9,2,0
(v6,2,65536,0.266667,0.333333,6.2,0.333333,7,0,8,0)
(v6,3,65536,6.2,0.333333,6.2,3.733333,7,0,8,0)
(v6,4,65536,6.2,3.733333,0.266667,3.733333,7,0,8,0)
(v6,5,65536,0.266667,3.733333,0.266667,0.333333,7,0,8,0))))
(t14,6,0,0.6,0.733333,0,7,0,0,,wst:swiss10,Text\ of\ screen\ currently\ being\
displayed)
(t14,7,0,0.4,3.466667,0,7,0,0,,wst:swiss10,Cit:\ Stack/\ n\ of\ m\ \("search\ s
tring"\)\ --\ Ada\ LRM\ Reader\ n.n\ Command:)
(t14,8,0,3.666667,1.733333,0,7,0,0,,wst:swiss10,22\ lines\ of\ text\ by\ 75\ co
lumns)
(v6,9,0,4.533333,1.466667,4.533333,0.333333,7,0,8,0)
(v6,12,0,4.533333,1.866667,4.533333,3.266667,7,0,8,0)
(t14,15,0,2.6,3.666667,0,7,0,0,,wst:swiss10,Error\ Message\ Line)
(v6,16,0,3.8,3.6,6.133333,3.6,7,0,8,0)
(v6,17,0,2.533333,3.6,0.266667,3.6,7,0,8,0)
(t14,18,0,0.666667,1.066667,0,7,0,0,,wst:swiss10,This\ line\ contains\ the\ sea
rch\ string\ and\ is\ pointed\ to\ by\ the\ \<\ on\ the\ right.\ \ \ \ \ \ \ \
\ \ \ \ \ \ \ \ \ \ \ \<)
(g9,87,8
(v6,87,0,4.533333,3.266667,4.533333,3.066667,7,0,8,0)
(g9,89,1025
(p8,89,0,5,7,0
(g9,89,0
(g9,89,0
(v6,89,0,4.478608,3.116314,4.533333,3.266667,7,0,8,0)
(v6,90,0,4.533333,3.266667,4.588056,3.116314,7,0,8,0)
(v6,91,0,4.588056,3.116314,4.533333,3.148389,7,0,8,0)
(v6,92,0,4.533333,3.148389,4.478608,3.116314,7,0,8,0))))
(v6,93,25167905,4.533333,3.266667,4.533333,3.266667,7,127,8,0)))
(g9,94,8
(v6,94,0,4.533333,0.333333,4.533333,0.533333,7,0,8,0)
(g9,96,1025
(p8,96,0,5,7,0
(g9,96,0
(g9,96,0
(v6,96,0,4.588057,0.483686,4.533333,0.333333,7,0,8,0)
(v6,97,0,4.533333,0.333333,4.478609,0.483686,7,0,8,0)
(v6,98,0,4.478609,0.483686,4.533333,0.451611,7,0,8,0)
(v6,99,0,4.533333,0.451611,4.588057,0.483686,7,0,8,0))))
(v6,100,25167905,4.533333,0.333333,4.533333,0.333333,7,127,8,0)))
(g9,101,8
(v6,101,0,0.266667,3.6,0.466667,3.6,7,0,8,0)
(g9,103,1025
(p8,103,0,5,7,0
(g9,103,0
(g9,103,0
(v6,103,0,0.417019,3.545275,0.266667,3.6,7,0,8,0)
(v6,104,0,0.266667,3.6,0.417019,3.654723,7,0,8,0)
(v6,105,0,0.417019,3.654723,0.384945,3.6,7,0,8,0)
(v6,106,0,0.384945,3.6,0.417019,3.545275,7,0,8,0))))
(v6,107,25167905,0.266667,3.6,0.266667,3.6,7,127,8,0)))
(g9,108,8
(v6,108,0,6.2,3.6,6,3.6,7,0,8,0)
(g9,110,1025
(p8,110,0,5,7,0
(g9,110,0
(g9,110,0
(v6,110,0,6.049648,3.654725,6.2,3.6,7,0,8,0)
(v6,111,0,6.2,3.6,6.049648,3.545277,7,0,8,0)
(v6,112,0,6.049648,3.545277,6.081722,3.6,7,0,8,0)
(v6,113,0,6.081722,3.6,6.049648,3.654725,7,0,8,0))))
(v6,114,25167905,6.2,3.6,6.2,3.6,7,127,8,0))))>
<HR>
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
<|,12>The above display shall be divided into three areas:
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Restart = Yes, Value = 1.><End Sub>
<F0>an area for the text to be displayed (lines 1 to 22),
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 2.><End Sub>
<F0>a command prompt and input line (line 23), and
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 3.><End Sub>
<F0>an error message line (line 24).
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The command prompt shall indicate the citation currently being displayed,
the number of levels deep the user is on the location stack, the number
of the current screen in the citation, the total number of screens
in the citation, and the current search string (truncated if necessary
so the line does not wrap). The current search string shall appear
only if the previous command was a search or search next command.
<paragraph,
Alignment = Left,
Left Tab = 0.50/1.50 Inches>
The line containing the search string shall be identified by a less
than sign (<<) appearing in column 79 of the line.
<section>
<|,13><"|:section", Subcomponent = yes><F0>
<Autonum, List, 1, Tagname = o6Nxf334conn, Value = 5.><End Sub><F0>
Reference Manual - Error messages
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Restart = Yes, Value = 1.><End Sub>
<F0> Invalid Command - Reenter or type HELP for help<HR>
<HR>
This message is displayed when the command entered by the user is
not resolved as an expected command or as a citation. This error
is not fatal.<HR>
<HR>
See Section <Ref, Auto #, Value = 4.2.6., Tag = kxmwf276conn>
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 2.><End Sub>
<F0> Cannot advance beyond the end of this citation<HR>
<HR>
This message is displayed when the user attempts to execute the N
or NEXT command and the current screen is the last screen of Appendix
F or one of the following: CONTENTS, INDEX, POSTSCRIPT, FOREWARD,
or HELP. This error is not fatal.<HR>
<HR>
See Section <Ref, Auto #, Value = 4.2.3.1., Tag = Eymwf37aconn> See
also Section <Ref, Auto #, Value = 4.2.3.3., Tag = "E@mwf172conn">
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 3.><End Sub>
<F0> Cannot back up before the beginning of this citation<HR>
<HR>
This message is displayed when the user attempts to execute the P
or PREVIOUS command and the current screen is the first screen of
Chapter 1 or one of the following: CONTENTS, INDEX, POSTSCRIPT, FOREWARD,
or HELP. This error is not fatal.<HR>
<HR>
See Section <Ref, Auto #, Value = 4.2.3.2., Tag = uzmwf2c6conn> See
also Section <Ref, Auto #, Value = 4.2.3.4., Tag = "s@mwf33econn">
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 4.><End Sub>
<F0> DAF FIle Not Found<HR>
<HR>
This message is displayed when the <LRM_Name, Subcomponent = yes><F40>Ada
LRM Reader<End Sub><F0> attempts to access a citation and cannot find
the data file containing the information on the citation. This means
that there is a problem with the installation and you should check
into the *.daf files (DAF = Direct Access File), making sure they
are in the correct directory. This error is fatal and will cause
the program to abort.
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 5.><End Sub>
<F0> Location stack is empty<HR>
<HR>
This message is displayed when the user attempts to execute the POP
command and the location stack is empty (there is no element to which
to pop). This error is not fatal.<HR>
<HR>
See Section <Ref, Auto #, Value = 4.2.3.6., Tag = i3nwf1eaconn>
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 6.><End Sub>
<F0> Location stack is full<HR>
<HR>
This message is displayed when the user attempts to execute the PUSH
command and the location stack is full. This error is not fatal.<HR>
<HR>
See Section <Ref, Auto #, Value = 4.2.3.5., Tag = P1nwfbeconn>
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 7.><End Sub>
<F0> Print log file error<HR>
<HR>
This message is displayed when the user attempts to execute the PRINT
or PS command and the output log file cannot be created to appended.
This error is not fatal.<HR>
<HR>
See Section <Ref, Auto #, Value = 4.2.2.1., Tag = "xHJ@f352conn">
See also Section <Ref, Auto #, Value = 4.2.2.2., Tag = "MIJ@f366conn">
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 8.><End Sub>
<F0> Search string not found<HR>
<HR>
This message is displayed when the user executes the / or // command
and the specified or de
<|,14>fault string is not found. This error is not fatal.<HR>
<HR>
See Section <Ref, Auto #, Value = 4.2.4.1., Tag = L7nwf1econn> See
also Section <Ref, Auto #, Value = 4.2.4.2., Tag = o7nwf276conn>
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 9.><End Sub>
<F0> Too many screens for internal buffers<HR>
<HR>
This message is displayed when an internal error occurs. This error
is caused by the limited number of screen buffers (defined in package
SYSDEP as Max_Number_of_Screens) is exceeded. A maintainer of the
<LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0> should
be contacted to correct the error. This error is fatal.
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 10.><End Sub>
<F0> Unexpected Error -- Continuing<HR>
<HR>
This message is displayed when an error condition arises in which
the <LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>
has encountered an problem that was not anticipated. A maintainer
of the <LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0>
should be contacted to correct the error. This error is not fatal.
<paragraph>
The following error messages may also appear. They represent internal
errors which indicate that there is either a bug in the code of the
<LRM_Name, Subcomponent = yes><F40>Ada LRM Reader<End Sub><F0> or
that the *.daf files have not been placed in the proper location or
have been damaged in some way. First check out the *.daf files before
looking at the source code or seeking further help.
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Restart = Yes, Value = 1.><End Sub>
<F0> Internal DAF Error - No DAF Open
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 2.><End Sub>
<F0> Internal DAF Error - Read Error
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 3.><End Sub>
<F0> Internal DAF Error - Stack Overflow
<list>
<"|:list", Subcomponent = yes><F0><Autonum, NList, 1, Value = 4.><End Sub>
<F0> Internal DAF Error - Unexpected Error
<section>
<|,15><"|:section", Subcomponent = yes><F0><Autonum, List, 1, Value = 6.><End Sub>
<F0> Notes
<paragraph,
Alignment = Left,
Left Tab = 1/1.50 Inches>
<F92@U>Acronyms<F0><HR>
<HR>
<F86>Acronym<Tab>Meaning<F0><HR>
Ada LRM<Tab>Ada Language Reference Manual<HR>
ASCII<Tab>American Standard Code for Information Interchange<HR>
CLI<Tab>Command Line Interface<HR>
<<CR><Tab>Carriage Return (key or ASCII character)<HR>
CSC<Tab>Computer Software Component<HR>
CSCI<Tab>Computer Software Configuration Item<HR>
CSU<Tab>Computer Software Unit<HR>
I/O<Tab>Input/Output<HR>
LRM<Tab>Language Reference Manual (Ada)<HR>
MSDOS<Tab>Microsoft Disk Operating System (for the PC)<HR>
PC<Tab>Personal Computer (compatible with the IBM 80x86-family)<HR>
SRS<Tab>Software Requirements Specification<HR>
SUM<Tab>Software User's Manual<HR>
UNIX<Tab>an operating system (not an acronym)<HR>
VDD<Tab>Version Description Document<HR>
VT100<Tab>Video Terminal model 100 by Digital Equipment Corporation